home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / sound / mp219b.zip / MODPLAY.DOC < prev    next >
Text File  |  1992-02-26  |  25KB  |  563 lines
  1.  
  2.      MODPLAY PRO *********                            (C) Mark J Cox
  3.      MODPLAY PRO **                                        1990/1991
  4.      MODPLAY PRO *******                              
  5.      MODPLAY PRO **************                         Version 2.19b
  6.  
  7.      Play AMIGA 4 channel sampled music files on a PC 
  8.     
  9.  
  10.      I. QUICK START
  11.      ─────────────────────────────────────────────────────────
  12.  
  13.      If you are impatient and don't want to read all the documentation before 
  14.      trying this program, type:
  15.  
  16.                 mp        
  17.      or         mp -a-i   If your machine is 10Mhz - 12Mhz
  18.  
  19.  
  20.      II. EXTRA INFORMATION
  21.      ─────────────────────────────────────────────────────────
  22.  
  23.      1          If your video card supports text modes such as 25*132,
  24.                 44*132, 60*132 or just about any other text mode then enter
  25.                 this mode (using the utility supplied with your card) and
  26.                 MODPLAY PRO will take full advantage of it when selecting 
  27.                 filenames
  28.  
  29.      2          Modplay Pro now has full PROTRACKER support.  See a later 
  30.                 section for details.  MODPLAY can execute your programs
  31.                 while playing mods - see section 3.1
  32.  
  33.      3          The Modplay config file must exist in one of two places
  34.         i)  The current directory
  35.         ii) The directory in which the copy of MP.COM you are running
  36.             is in.
  37.   
  38.      4          Modplay Pro will now view .GIF files including GIFs that have
  39.                 been GIFLITE'd and GIF89's.  The last .GIF file viewed will be
  40.                 used as the background to the VGA scope display (F10 when
  41.                 playing).  No support for Interlaced GIF's.
  42.   
  43.  
  44.      III.  INTRODUCTION TO MODPLAY PRO
  45.      ─────────────────────────────────────────────────────────
  46.  
  47.      Modplay Pro allows you to play Amiga soundtracker/noisetracker files,
  48.      Protracker files and even 4 channel Startrekker files on a PC 
  49.      (10Mhz or faster clock speed, 286 processor or better).  
  50.      Modplay Pro is written *entirely* in assembler and now runs to over
  51.      11,000 lines of source and has taken around 400 hours to produce.
  52.  
  53.      *** DOES NOT ALWAYS WORK WHEN USING emm386 ON A 386 PC ***    
  54.  
  55.  
  56.      1.   WHAT ARE MODULES?
  57.      ─────────────────────────────────────────────────────────
  58.  
  59.      A module consists of 15 (or 31) sampled instruments and a four channel
  60.      music track.  By playing the instruments at different pitches a
  61.      soundtrack lasting many minutes can be produced.  The PC speaker is not
  62.      really up to handling modules, since in total we have a 10 bit sample
  63.      to be played, and the speaker can only handle 5 (and thats only just
  64.      possible).  A D/A converter gives 8 and the stereo version gives 
  65.      effectively 9. The output sounds OK through a good sized PC speaker, the 
  66.      cheap piezo devices found in some computers including laptops are not 
  67.      really designed to cope.  So through external hardware MODPLAY PRO comes 
  68.      close to the quality you would get on an AMIGA.
  69.  
  70.  
  71.      2. IMPLEMENTATION
  72.      ─────────────────────────────────────────────────────────
  73.  
  74.      MODPLAY PRO implements all Amiga effects such as vibrato etc.
  75.      Most Amiga modules have samples in them that are less than 64k each in
  76.      length, these can be played as normal on any 286 10Mhz or better;  a
  77.      rare few have samples >64k in them and although these will be played
  78.      by modplay pro you really need a 16MHz machine minimum to keep up.  These 
  79.      modules are marked with a '*' on the top line of the display next to the
  80.      filename when they are playing.
  81.  
  82.      2A. PROTRACKER
  83.      ─────────────────────────────────────────────────────────
  84.  
  85.      On the Amiga there are a wide variety of tracker players.  By far
  86.      the best (personal opinion) is the Protracker player.  Protracker
  87.      modules can have many more commands in them (Thinks like Tremelo,
  88.      Note delays,  Repeat loops,  etc)  and I have recently found many
  89.      modules are Protracker ones and so benefit greatly by implementing
  90.      this new set of commands.  All Protracker commands execept FunkInvert
  91.      (EFx) are implemented (FunkInvert just plays a sample sort of
  92.      backwards... this would mean changing my interrupt routines a little
  93.      too much and would slow down normal songs)
  94.  
  95.  
  96.      3. MODPLAY PRO OPTIONS - COMMAND LINE PLAYING
  97.      ─────────────────────────────────────────────────────────
  98.  
  99.      From the command line a module can be played through any of the output
  100.      devices with or without a moving graph display.  The format is 
  101.  
  102.      MP [-q] [-0..6] [-a/-b] [-output device] [filename [.MOD]
  103.  
  104.      Items in [ ] are optional.   The -q if present tells MODPLAY PRO not to
  105.      display any text and so the module will play without disturbing the
  106.      text display.  (You could use this in a game's title screen written
  107.      in C or Basic, by doing a system or shell command - MODPLAY PRO exits when
  108.      a key is pressed).  The -(number) tells MODPLAY PRO what hardware to play
  109.      the module through.  The filename can contain wildcard characters
  110.      (*,?), so MP * would be valid and would play all the *.MOD files
  111.      in the current directory one after the other.  Playback of a sequence
  112.      of files can be aborted by pressing ESCape two or three times in rapid
  113.      sucession.  
  114.  
  115.      -0  is the PC Speaker (default unless a stereo-on-one card is found)
  116.      -l1 is a D/A converter on printer port 1
  117.      -l2 is a D/A converter on printer port 2
  118.      -l3 is a D/A converter on printer port 3
  119.      -l4 is a D/A converter on printer port 4
  120.      -ls is 2 D/A converters, one on port1 the other on port2 (gives stereo)
  121.      -lm is 2 D/A converters as above but giving mono.
  122.  
  123.      -xm
  124.        This is of use if you have a single D/A converter on an expansion
  125.        port or any known address.  Use -xm(address) where the address is
  126.        a 3 digit hex number.  (Example -xm3B7 would play in mono to a
  127.        D/A converter at address 03B7) 
  128.     
  129.      -xs
  130.        This is similar to -xm, allowing two D/A converters and hence stereo
  131.        operation.  Use -xs(address1)(address2).  [Example, -xs300301 would
  132.        play in stereo to D/A converters at 0300 and 0301.  Note that these
  133.        switchs must be used from the command line and cannot be changed when
  134.        inside MODPLAY PRO
  135.  
  136.      -xq 
  137.        Similar to -xs, allowing four D/A converters - this gives the Best
  138.        possible quality!  But it may not work too well on slower computers.
  139.        Use -xq(address1)(address2)(address3)(address4) [ Example
  140.        -xq3003BC2F93DC would play to D/As at 0300, 03BC, 02F9 and 03DC.]
  141.        As with -xs, all the addresses must be different!
  142.  
  143.      -y1 (-y2,...-y4)
  144.        Disney Sound Source D/A.  This output routine is designed to drive
  145.        the Disney D/A converter (that is supplied with some games etc.).  The
  146.        Disney D/A sits on a parallel port but must be clocked after each
  147.        sample (unlike the standard D/A in hardware.doc) and turned on and off.
  148.        -y1 would output to a Disney D/A on LPT1, -y2 on LPT2 etc.   A normal
  149.        D/A converter on a parallel port will work with this option as well,
  150.        although it is not recommended as it is more processor intensive.
  151.  
  152.      Stereo-on-1
  153.        Modplay Pro will autodetect a Stereo-on-1 board on any Parallel port and
  154.        use it.  See HARDWARE.DOC for more information
  155.  
  156.      Soundblaster
  157.        Modplay Pro will autodetect a Soundblaster card at any base address and
  158.        use it. 
  159.  
  160.      (Using a /number will ignore anything autodetected).
  161.  
  162.      -a should be used if your computer crashes when playing tunes, it
  163.         decreases the rate of playing samples - decreasing the quality
  164.         noticably through the speaker, but should mean 10Mhz-12Mhz machines
  165.         can cope.
  166.      -b This is the default mixing speed designed for a 12MHz PC
  167.  
  168.      -d This option is used when if you don't like my choice of character 
  169.         for drawing the bars.  I've had lots of mail all saying you